HC2ENTRY.TXT HEC2 ENTRY, Shareware Version 1.04, November 25, 1987 The purpose of this program is to allow an input file for HEC-2 to be quickly created without constant reference to the manual. The program prompts for required information, and most optional information, with some error-checking capabilities such as data field length and data type (alphanumeric, integer, real number, etc.). Also, some cross- checking of HEC-2 variables vs. prompting for related data in later entries takes place. Editing data entered at the prompts is limited to the backspace key; the cursor keys and delete key are disabled. The data must be well organized, as no editing of previous entries is allowed, other than the current "card", via a "Q" command. An exception to that rule is the group of X1 thru GR cards, which allows restarting the entire cross section, because the GR routine checks for proper left bank and right bank locations as specified on the X1 card, and stations on the BT cards versus the GR cards. The sequence of data entry pretty much follows Table 3 in the HEC-2 manual. This program can't really allow for all HEC-2 options, as it is run with menus and prompts, and it would be pretty cumbersome to wade through prompts for data that is not required most of the time. However, it can still be used to create most of the input file, and be assured that the fields are formatted properly. The current version does allow for fields within the J1 and J2 cards which reference other cards which are not supported, such as the QT, ET, X5 and CI cards. Those cards will have to be created with your text editor. The main function of this version is to allow a simple multiple profile job to be run. Options will be added to future versions in the following order: (1) those I find a need for while using HEC-2, and (2) those that other users agree are desirable. If printed output is desired, select the proper choice when prompted. Printed output is formatted for readability and not so you can check field lengths and locations, so don't bother checking formatting on the printout. Following are some notes regarding input and limitations: 1. Aborting or restarting individual card routines: A prompt at the top of the screen will tell you the effect of entering a "q" or "Q". "Abort" means the program will abort at this point, creating the data file, such as it is. "Restart", which prompt will appear usually after you have started entering data within a particular card routine, means that the program will start that routine over. "Back up" will be seen within the BT and GR entry routines, and will allow you to back up to the previous station to correct an error. Entering "Q" repeatedly will back you out of the routine and the program. 2. File name: The file name may consist of alphanumeric characters only. An extension of ".DTA" is used. The program will prompt before overwriting a file. Once you are past this point in the program, the file will be created, even if you abort the program, so be sure you want to overwrite an existing file before choosing yes. 3. Archival cards (AC): Not supported at this time. 4. Comment cards (C_): Prompts for the proper number of comment cards based on user input for NUMCT. 5. Title cards (T1-T3): Prompts for three title cards, including the stream name as a separate prompt for T3. Indents all titles by 6 spaces, consistent with examples in the manual. If you want a blank title card, press "spacebar", "return". 6. Job Control cards a) J1 card: Prompts for J1 card and all variables. Fully supports all HEC-2 options except for variable STRT for number of rating curve pairs on JR card, which is limited to 5 maximum. b) J2 card: Prompts for J2 card, which is optional for first profile, but requires J2 card if more than 1 J1 card has been created (multiple profiles). Only prompts for number of profile or if last profile if user does not request J2 card. If user requests J2 card, then prompts for all variables with following limitations: 1) "-" value for variable FN is not supported. 2) Value 15 for variable ITRACE is not supported. c) J3 card: Only prompts for this card after the first J1 card. Variable IVAR is limited to the codes for pre-defined tables. d) J4 card: Not supported at this time. e) J5 card: The "summary printout only for all cross sections" option is the only supported option if a J5 card is chosen. f) J6 card: Only variable IHLEQ (friction loss equations) option is supported. The disk/tape output transfer is not supported. 7. Change cards a) Only the NC card is supported at this time. The NH, NV, QT and ET cards are scheduled for partial support in a future upgrade. 8. Cross section cards a) The X1 card is fully supported except for the following: 1) Negative SECNO (start new tributary backwater). 2) PXSECR and PSXECE factors, to change stations and elevations. b) The CI card is not supported, but is scheduled for a future upgrade. c) The X2 card is only partially supported in that QNEW, a new river flow, may be added. Other variables will be supported in a future upgrade. d) X3 cards are not supported, but partial support is scheduled for a future upgrade. e) The X4 card is not supported. f) The X5 card is not supported, but is scheduled for a future upgrade. g) BT cards are supported with up to 100 stations. h) GR cards are supported with up to 100 data pairs. MAIL SUPPORT I intend to respond in a timely fashion to all requests, comments, and questions from registered users. I welcome comments from unregistered users also, as that is the only way I will know which enhancements the users prefer. Unregistered users may or may not get a response, however. If you are undecided about registration because of the limitations of this version, let me know, and if possible I will add the enhancements you want and send you the upgraded shareware version for your review. I will request a $10 handling charge before sending it out, however. If any registered users uncover a fatal bug in HC2ENTRY, I will send a fixed version free. The latest shareware version will always be available for $10. SYSTEM CONFIGURATION HC2ENTRY will run on any MS-DOS compatible machine with 256K RAM and DOS 2.11 or later. It will create the data file on the drive and subdirectory the program is located within. It will work from a hard disk or floppy drive. REGISTRATION This program is shareware, which means you are free to copy and distribute it as described within the beginning screen message. Sending a contribution of $35 to the author constitutes registration and will result in the following benefits to the user: 1. Receipt of a diskette with the latest version of HC2ENTRY, without the shareware entrance screen. 2. Full support (by mail) of all questions regarding use of HC2ENTRY and HEC-2. I am not and probably will never be a "power user" of HEC-2, but in writing and testing this program I have become familiar with some of HEC-2's idiosyncrasies. 3. Placement on a mailing list for notification of availability of future enhanced versions, which will be available for $10. Please send contributions to: Richard Wadsworth 320 Eureka Canyon Road Watsonville, CA 95076 ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of The Public (Software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. The P(s)L cannot de- bug programs over the telephone. Disks in the P(s)L are updated monthly, so if you did not get this disk directly from the P(s)L, you should be aware that the files in this set may no longer be the current versions. For a copy of the latest monthly software library newsletter and a list of the 1,000+ disks in the library, call or write The Public (Software) Library P.O.Box 35705 - F Houston, TX 77235-5705 (713) 721-6104 or (713) 721-5205